USB Management Services Functions4

The USL provides an interface to services provided by the USB Manager. These services make it so class drivers need only link against the USB Services library or driver services library.

USBExpertInstallDeviceDriver

The USBExpertInstallDeviceDriver function notifies the USB Manager that there is a device that needs a driver matched and loaded. Typically only hub drivers need the service provided by this function.



 
OSStatus USBExpertInstallDeviceDriver(USBDeviceRef ref, 

                                          USBDeviceDescriptorPtr *desc

                                          USBReference hubRef, 

                                          UInt32 port,

                                          UInt32 busPowerAvailable);

The ref parameter can be a device reference or an interface reference. Similarly the desc parameter can be a device or interface descriptor.

ref: Device reference of the new device.
desc: Device descriptor of the device to find a driver for.
hubRef: The device reference of the parent hub of this device.
port: The parent port of this device.
busPowerAvailable: How much current is available from the bus for the device, in 2 milliamperes (mA) units. This should have one of two values, 100mA for a bus-powered hub parent and 500mA for a self-powered parent.

USBExpertRemoveDeviceDriver

The USBExpertRemoveDeviceDriver function notifies the USB Manager that a device has been removed from the bus and that the class driver for that device needs to be terminated. Typically only hub drivers need the service provided by this function.



 
OSStatus USBExpertRemoveDeviceDriver(USBDeviceRef ref);

The ref parameter can be a device reference or an interface reference.

ref: Device reference of the device removed from the bus.

USBExpertInstallInterfaceDriver

The USBExpertInstallInterfaceDriver function notifies the USB Manager that a class driver needs to be loaded for the given interface of the given device. This function is used by class drivers that select configurations and interfaces. The drivers that use this functionality are typically composite class drivers.



 
OSStatus USBExpertInstallInterfaceDriver(USBDeviceRef ref, 

                                          USBDeviceDescriptor *desc, 

                                          USBInterfaceDescriptor *interface,

                                          USBReference hubRef, 

                                          UInt32 busPowerAvailable);

ref: Device reference of device containing the interface. (Note that this will eventually become an interface reference.)
desc: Device descriptor of the interface to find a driver for.
interface: Interface descriptor of interface to find a driver for.
hubRef: The device reference for the device containing this interface. Usually a device reference of a hub.
busPowerAvailable: How much current is available from the bus for the device, in 2 milliamperes (mA) units. This should have one of two values, 100mA for a bus-powered hub parent and 500mA for a self-powered parent.

USBExpertRemoveInterfaceDriver

The USBExpertRemoveInterfaceDriver Function notifies the USB Manager that a device has been removed from the bus and that the class driver needs to be disposed.



 
OSStatus USBExpertRemoveInterfaceDriver(USBInterfaceRef ref);

ref: Interface reference from the removed device

`kUSBBadDispatchTable`	`-6950`	improper driver dispatch table
`kUSBUnknownNotification`	`-6949`	notification type not defined
`kUSBQueueFull`	`-6948`	internal queue full